Carteira de Trabalho e Previdência social
- Upload
- Buscar documento
- Modelo
Para efetuar o upload de um documento do tipo Carteira de Trabalho e Previdência social, basta enviar uma requisição POST conforme demonstrado abaixo. O seu código interno é o 79.
POST URL Ambiente/documents/upload
Header
| Identificador | Valor |
|---|---|
| Content-type | multipart/form-data |
| IDEXA-API-KEY | [api_key] |
Payload
| Parâmetro | Descrição | Obrigatório | Tipo | Exemplos |
|---|---|---|---|---|
| files | Documento(s) a ser(em) processado(s) | Sim | File | "arquivo.pdf" |
| type | Tipo do documento enviado | Sim | Integer | 79 |
| pages | Páginas a serem analisadas (Quando extensão for pdf) | Não | String | "1,2,5-10" |
| externalId | Id externo para controle do documento (não pode repetir) | Não | String | "0001" |
Exemplo
('files',('arquivo.pdf',open('/path/to/file/arquivo.pdf','rb'),'application/pdf'))
{
"type": 79,
"pages": "1,2,5-10",
"externalId": "0001"
}
Retorno
Status code 200
Ao enviar um documento, o retorno 200 dado pela api, irá enviar um objeto data nulo pois a inferência do documento ainda será feita. Para obter o resultado da Inteligência Artificial, é necessário utilizar a requisição vista na próxima sessão.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 79 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error, 3-In Progress) | Integer | 0 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, IN_PROGRESS, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 79,
"status": 0,
"statusDesc": "RECEIVED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
Para buscar o resultado do documento processado, disponibilizamos o método GET, mostrado a seguir. Pasta passar no parâmetro id, o UUID recebido no momento do upload.
GET URL Ambiente/documents/[id]
Header
| Identificador | Valor |
|---|---|
| Content-type | application/json |
| IDEXA-API-KEY | [api_key] |
Retorno
Status code 200
Um http code 200 é retornado quando o documento é inserido corretamente.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 79 |
| data | Objeto retornado pela IA | Modelo referente ao tipo do documento | json_object |
| processTime | Tempo de processamento | Float | 10.02232 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error) | Integer | 3 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 79,
"data": {
// Verificar em Modelo o resultado esperado desse documento
},
"processTime": null,
"status": 1,
"statusDesc": "FINISHED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| documentType | Document Type | String | CTPS |
| walletNumber | Work Permit Number | String | 123456 |
| series | Work Permit Series | String | 0001-DF |
| issueState | Issuance Status | String | DF |
| issueDate | Issue Date | String | 15/05/2005 |
| pisNumber | PIS/PASEP number | String | 123.45678.90-1 |
| documentValidation | Document Validation | Boolean | True |